Skip to main content

mergButtonGet

Type

function

Summary

Get a button property

Syntax

mergButtonGet(<pName>, <pProperty>, [<pState>])

Description

Get a button property

Parameters

NameTypeDescription

pName

A name to be used to reference the button

pProperty

The property to set

  • reverses title shadow when highlighted
  • adjusts image when highlighted
  • adjusts image when disabled
  • shows touch when highlighted
  • tint color : R,G,B. The tint color to apply to the button title and image.
  • content edge insets : Use this property to resize and reposition the effective drawing rectangle for the button content. The content comprises the button image and button title. You can specify a different value for each of the four insets (top, left, bottom, right). A positive value shrinks, or insets, that edge—moving it closer to the center of the button. A negative value expands, or outsets, that edge.
  • title edge insets : Use this property to resize and reposition the effective drawing rectangle for the button title. You can specify a different value for each of the four insets (top, left, bottom, right). A positive value shrinks, or insets, that edge—moving it closer to the center of the button. A negative value expands, or outsets, that edge. The insets you specify are applied to the title rectangle after that rectangle has been sized to fit the button’s text. Thus, positive inset values may actually clip the title text.
  • image edge insets : Use this property to resize and reposition the effective drawing rectangle for the button image. You can specify a different value for each of the four insets (top, left, bottom, right). A positive value shrinks, or insets, that edge—moving it closer to the center of the button. A negative value expands, or outsets, that edge.
  • visible : Show or hide the button.
  • rect : left, top, right, bottom. Set the location and size of the button.
  • title : Sets the title of the button for a particular state
  • font : In the form fontname,fontsize
  • title color
  • image : Sets the image of the button for a particular state. The value must be set to the content of the image file or the text of an image object.
  • background image : Sets the background image of the button for a particular state. The value must be set to the content of the image file or the text of an image object.
  • border color
  • border width
  • corner radius
  • background color
  • enabled

pState

(optional with "normal" default) The state with which to use the title, image or background image. At a minimum, you should set the value for the normal state. If a title, image or background image is not specified for a state, the default behavior is to use the title, image or background image associated with the normal state.

  • normal
  • highlighted
  • disabled
  • selected

Compatibility and Support

Introduced

LiveCode 8.0

OS

ios

Platforms

mobile

Thank you for your feedback!

Was this page helpful?